home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 05 Programming / SHLRAM.SDA / SHELLRAM.EDME < prev    next >
Text File  |  2019-04-13  |  5KB  |  182 lines
  1.  
  2.    SHELLRAM: ┴ SHELL FOR ╨╧╫┼╥ ├
  3.      DESIGNED TO WORK WITH THE
  4.           1764 ╥┴═ DISK
  5.  
  6.  ╘HE FILES IN THIS ARCHIVE ALLOW YOU
  7. TO ASSEMBLE, USING C/ASSM, AND LINK,
  8. USING THE ╨╧╫┼╥ ├ LINKER, A SHELL WHICH
  9. CAN BE USED ON THE ├OMMODORE 64 IN
  10. CONJUNCTION WITH THE ├OMMODORE 1764
  11. 256╦ ╥AM ┼XPANDER, SINCE IT LEAVES
  12. A PAGE OF MEMORY FREE FOR USE AS THE
  13. "╥┴═ ─ISK ╔NTERFACE ╨AGE", AS REQUIRED
  14. BY THE ╥┴═ ─ISK ╙OFTWARE AS PROVIDED
  15. WITH THE CARTRIDGE.
  16.  
  17. ╘O ASSEMBLE IT WILL REQUIRE THE C/ASSM
  18. PROGRAM, FROM ═ARK ╥INFRET AND ╥AY
  19. ┌ARLING.  ┼ACH ".A" FILE FROM THIS
  20. ARCHIVE SHOULD BE ASSEMBLED TO PRODUCE
  21. THE CORRESPONDING ".O".
  22.  
  23. ╠INKING WILL REQUIRE THE ╨╧╫┼╥ ├ (OR ├
  24. ╨OWER) LINKER, AS FOLLOWS:
  25.  
  26. $ LINK -S $0801
  27.  
  28. > SHELLMAIN.O
  29. > C$GETCHAR.O
  30. > DPRINTF.O
  31. > DOLOAD.O
  32. > SRCHCMD.O
  33. > SHELLSTR.O
  34. > SHELLCENV.O
  35. > C64KERNAL.O
  36. > SHELLVAR.O
  37. >
  38.  
  39. OUTPUT FILE NAME: SHELLRAM
  40.  
  41. $
  42.  
  43. ╘O RUN IT, USING THE ╥┴═ DISK, THE ╥┴═
  44. DISK SHOULD FIRST BE INITIALIZED,
  45. USING PAGE 22 (HEX $16) AS THE 
  46. INTERFACE PAGE.  ╘HE SMALL BASIC PROGRAM
  47. ON THE DISK, 'CSTART', ACTUALLY DOES
  48. THIS FOR YOU.  ╔T REQUIRES A COPY OF THE
  49. ╥┴═ DISK BINARY IMAGE, RAMDOS??????.BAS,
  50. TO BE COPIED ONTO THE DISK.  ╘HIS
  51. PROGRAM SHOULD HAVE COME WITH YOUR 1764
  52. ╥┴═ EXPANDER.  'CSTART' ALSO ARRANGES TO
  53. USE THE 'EXEC' UTILITY (WHICH YOU MAY OR
  54. MAY NOT HAVE), TO SET UP YOUR ╥┴═ DISK
  55. FOR USE.
  56.  
  57. ╘HE ├ PROGRAM 'TWINCOPY' IS A RELATIVELY
  58. CONVENIENT WAY OF COPYING FILES FROM A
  59. REAL DISK TO THE ╥┴═ DISK, OR VICE
  60. VERSA.  'TWINCOPY' WILL COPY FILES FROM
  61. THE CURRENT 'SYS' DEVICE TO THE CURRENT
  62. 'WORK' DEVICE.
  63.  
  64. ╘HEREFORE:
  65.  
  66. % SYS 8 0
  67. % WORK 9 0
  68. % TWINCOPY XXX
  69.  
  70. WILL COPY FILE 'XXX' FROM A DEVICE 8 TO
  71. DEVICE 9.  ╒SUALLY THIS WILL COPY FROM
  72. A REAL DISK TO THE ╥┴═ DISK.
  73.  
  74. % SYS 9 0
  75. % WORK 8 0
  76. % TWINCOPY XXX
  77.  
  78. WOULD COPY THE OTHER WAY.
  79.  
  80. ╬OTE THAT 'TWINCOPY' MUST BE LINKED
  81. WITH THE OBJECT FILE 'SHELLCENV.O' TO
  82. RESOLVE SOME OF ITS REFERENCES.
  83.  
  84.  
  85. ┼XTRA FEATURES IN 'SHELLRAM':
  86.  
  87. 1) A 'COL' COMMAND CAN BE OPTIONALLY
  88. ASSEMBLED IN (THE SOURCE IS DISTRIBUTED
  89. TO PROVIDE IT), COMPATIBLE WITH THE
  90. 'COL' COMMAND OF THE ╨╧╫┼╥ ├ 128 SHELL:
  91.  
  92. COL <CHAR> <BACKGROUND> <DUMMY> <BORDER>
  93.  
  94. 2) ╙INCE LEADING NON-ALPHABETICS ARE
  95. ALWAYS IGNORED ON EACH COMMAND LINE,
  96. LINES CAN EASILY BE RE-ENTERED BY
  97. CURSORING UP TO THEM AND PRESSING
  98. <RETURN>.  ╙OME PEOPLE MIGHT NOT LIKE
  99. THIS IF THEY HAVE TAKEN TO SAYING THINGS
  100. LIKE ">> PRINT ...", BUT "PRINT ... >>"
  101. IS EQUIVALENT.
  102.  
  103. 3) ┬ETTER MANAGEMENT IS DONE OF THE
  104. FILE UNITS USED FOR COMMAND CHANNELS.
  105. ╘HIS IS PRIMARILY OF SIGNIFICANCE TO
  106. USERS OF DUAL DISK DRIVES, SUCH AS THE
  107. ═╙─ ╙─-2.  ╔T ALLOWS "LS >", AND,
  108. MEANS THAT PROGRAMS LOADED FROM THE
  109. SYS DRIVE OF THE DUAL DRIVE CAN DO
  110. FILE REDIRECTION THE FIRST TIME THEY
  111. ARE LOADED.  ╔F YOU HAVE A DUAL DRIVE,
  112. YOU MIGHT KNOW WHAT ╔ MEAN.  ╧THERWISE,
  113. DON'T WORRY ABOUT IT.
  114.  
  115. 4) PROMPT IS '%' RATHER THAN '$' TO
  116. REMIND YOU IT'S DIFFERENT.  ╧F COURSE,
  117. YOU CAN MODIFY THE SOURCE TO USE
  118. WHATEVER CHARACTER YOU LIKE.
  119.  
  120. ╘HE FILE 'NEWCC.A' IS A C/ASSM SOURCE
  121. TO PRODUCE A OF VERSION OF THE 'CC.SH'
  122. PROGRAM WHICH WILL WORK WITH BOTH 'SYS'
  123. AND 'WORK' DEVICES SET TO BE THE ╥┴═
  124. DISK.  ╘HE 'COMPILER' AND 'TRANSLATOR'
  125. PROGRAMS FROM THE ╨╧╫┼╥ ├ 64
  126. DISTRIBUTION DISK SHOULD BE COPIED TO
  127. THE ╥┴═ DISK, AS WELL AS THE ├ SOURCE
  128. TO BE COMPILED FOR THIS VERSION TO WORK.
  129. (╔T WILL ALSO WORK WITH REAL DISK
  130. DRIVES, HOWEVER).  ╔N ADDITION TO
  131. SUPPORTING THE ╥┴═ DISK, 'NEWCC' ALSO
  132. ALLOWS MORE THAN ONE ├ PROGRAM TO BE
  133. COMPILED WITH A SINGLE COMMAND LINE.
  134.  
  135. ╬OTE THAT BOTH 'TWINCOPY' AND 'NEWCC'
  136. MUST BE LINKED WITH THE OBJECT FILE
  137. 'SHELLCENV.O' TO RESOLVE SOME OF THEIR
  138. REFERENCES.
  139.  
  140.  
  141.  
  142.  
  143. ╨╥╧┬╠┼═╙ WITH THE 1764 ╔NTERFACE, AND
  144. THE ╥┴═─╧╙ SOFTWARE IN PARTICULA
  145. (╔N ADDITION TO THOSE NOTED IN THE
  146. ├OMMODORE DOCUMENTATION):
  147.  
  148. 1) ┴ SIMPLE
  149.  
  150. CHKIN,CHRIN,CLRCHN,CHKOUT,CHROUT,CLRCHN
  151.  
  152. LOOP TO ATTEMPT TO COPY FROM ONE FILE
  153. ON THE ╥┴═ DISK TO ANOTHER ALSO ON THE
  154. ╥┴═ DISK
  155.    
  156.    A) IS ╓┼╥┘ SLOW
  157.    B) GENERATES ERRONEOUS OUTPUT
  158.       CHARACTERS (AT 256 BYTE INTERVALS)
  159.  
  160. ┴ MULTIPLE CHARACTER BUFFER MUST BE
  161. USED, WHICH IS GENERALLY BETTER
  162. PROGRAMMING PRACTICE, ANYWAY.  ╙EE
  163. TWINCOPY.C, FOR EXAMPLE.
  164.  
  165.  
  166. 2) (╨OSSIBLY RELATED)
  167. ╫HILE PREPARING THE SHELL SOURCE
  168. ITSELF FOR DISTRIBUTION, ╔ DISCOVERED
  169. THAT ASSM.SH GENERATED ERRONEOUS OUTPUT
  170. WHEN ASSEMBLING A FILE ON/TO THE ╥┴═
  171. DISK.  ┬UT THIS WAS ONLY IN ONE CASE:
  172. ╘HE FILE SRCHCMD.A, WHEN THE SYMBOL
  173. COLCMD IS SET TO ZERO, WILL GENERATE
  174. ONE ERRONEOUS OUTPUT BYTE.  ╔ DON'T KNOW
  175. WHETHER THIS IS BECAUSE OF THE NATURE
  176. OF THE CONDITIONAL COMPILE, BECAUSE IT
  177. USES A .DSEG, OR SOME OTHER PROBLEM.
  178.  
  179.  
  180.            -- ┴DRIAN ╨EPPER
  181.               ═ARCH, 1988
  182.